home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / sas.man < prev    next >
Text File  |  1989-09-07  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. SAS                       User Commands                       SAS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      sas - SPUR assembler
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ssaass [ --aa ] [ --LL ]] [[ --pp ]] [[--II_p_a_t_h_n_a_m_e ] [ --oo objfile ] [
  13.      --DD_n_a_m_e[==_d_e_f ] [ --UU_n_a_m_e ] file
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      _S_a_s translates assembly code in the named _f_i_l_e into execut-
  17.      able object code in the specified _o_b_j_f_i_l_e.
  18.  
  19.      All undefined symbols in the assembly are treated as global.
  20.  
  21.      The output of the assembly is left in the file _o_b_j_f_i_l_e.  If
  22.      the --oo flag is omitted, file _a.._o_u_t is used.
  23.  
  24. OOPPTTIIOONNSS
  25.      --aa   Assemble only.  Normally, sas invokes the linker (sld)
  26.           to perform various normalizing tasks (backpatching for-
  27.           ward references, etc.).  This switch suppresses that
  28.           pass, leaving the "raw" assembly output in the output
  29.           file.  This option is seldom useful except for debug-
  30.           ging the assembler and linker.
  31.  
  32.      --pp   Invoke the preprocessor.  This runs the preprocessor,
  33.           cpp, over the input file.  It is necessary to do so in
  34.           the presence of preprocessor (#) directives.
  35.  
  36.      --ff   Allow ``fake'' operation codes that have significance
  37.           to the simulator.  By default, these are not allowed.
  38.           Additionally, when the -f switch is on, certain opera-
  39.           tions are given distinguished opcodes so that the simu-
  40.           lator can distinguish them.  Without the -f switch they
  41.           are synonyms for other instructions.  This option may
  42.           be expected to vanish in the future.
  43.  
  44.      --FF   Use the floating-point format of the machine running
  45.           sas.  This is useful only if you are going to run a
  46.           simulator on the host upon the result of the assembly.
  47.           This option may be expected to vanish in the future.
  48.  
  49.      --II_p_a_t_h_n_a_m_e
  50.           Include file directory.  Add _p_a_t_h_n_a_m_e to the list of
  51.           directories in which to search for ##iinncclluuddee files with
  52.           relative pathnames (not beginning with slash).  The
  53.           preprocessor first searches for ##iinncclluuddee files in the
  54.           directory containing _s_o_u_r_c_e_f_i_l_e, then in directories
  55.           named with --II options (if any), and finally, in
  56.           /_u_s_r/_i_n_c_l_u_d_e . The --II switch implies the --pp switch.
  57.  
  58.      --LL   Leave local labels starting with `L', the assembler
  59.           usually directs the linker to remove these.
  60.  
  61.  
  62.  
  63. SPUR Release 1.0           29 May 1988                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SAS                       User Commands                       SAS
  71.  
  72.  
  73.  
  74.      --DD_n_a_m_e[==_d_e_f
  75.           Define _n_a_m_e for the preprocessor, giving it value _d_e_f,
  76.           if the latter is supplied, and otherwise the null
  77.           string.  This switch implies --pp.
  78.  
  79.      --UU_n_a_m_e
  80.           Undefine any initial definition of symbol name for
  81.           cpp(1).
  82.  
  83. AASSSSEEMMBBLLEERR FFOORRMMAATT
  84.      SPUR assembly language conventions resemble those of `as'
  85.      for the VAX in the Berkeley release.  Immediate constants
  86.      begin with `$'.  Integer (floating-point, special) register
  87.      operands have the form r_n (f_n, s_n), or may be manifest
  88.      integer expressions.
  89.  
  90.      Numeric local labels are allowed, (re)defined by an integer
  91.      followed by a colon, and referenced as an integer followed
  92.      by `f' (next label defined with this number) or `b' (last
  93.      label defined with this number).
  94.  
  95.      The pseudo-operations `.text1,' `.text2,' `.text3,'
  96.      `.data1,' `.data2,' and `.data3' provide alternate text and
  97.      data assembly regions, which the assembler concatenates
  98.      after the default text and data regions.
  99.  
  100.      The pseudo-operations `.sdata,' `.sdata1,' `.sdata2,'
  101.      `.scomm,' and `.slcomm' are analogous to the operations
  102.      without the initial `s', but place or allocate from the
  103.      shared segment of memory.
  104.  
  105.      The assembler is much more liberal about load-time expres-
  106.      sions.  The values of these expressions may involve any
  107.      operands, symbolic or literal, whether or not defined in the
  108.      current assembly.  The defining expressions for `.set' sym-
  109.      bols are equally liberal, and all such symbols may be
  110.      exported.   The only restriction is that there may not be
  111.      circular dependences in the definition of any symbol.  Also,
  112.      certain expressions, such as those associated with `.org' or
  113.      `.space' or those designating registers, must still be mani-
  114.      fest.
  115.  
  116. SSEEEE AALLSSOO
  117.      sld(1), a.out(5)
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. SPUR Release 1.0           29 May 1988                          2
  130.  
  131.  
  132.  
  133.